home *** CD-ROM | disk | FTP | other *** search
/ 130 MIDI Tool Box / 130 MIDI Tool Box.iso / psed48v1 / psed.doc < prev    next >
Text File  |  1989-05-18  |  21KB  |  483 lines
  1.  
  2.  
  3.                                   PS Ed-480 
  4.                        Yamaha PSS-480 Tone Bank Editor
  5.                    for the IBM-PC and MPU-401 MIDI interface
  6.                                 Version 1.0
  7.  
  8.                     Copyright (c) 1989  by David Rutkowski
  9.                                2521 Riverside Dr.
  10.                              Grand Rapids, MI 49505
  11.                                 
  12.  
  13.  
  14.      1. Overview:
  15.  
  16.      The Yamaha PortaSound PSS-480 Music Station is probably the 
  17.      most sophisticated little synthesizer available for the money
  18.      (street price about $150-$170 U.S.) I have yet to hear of an
  19.      owner of one who isn't intrigued by, if not in love with, this
  20.      ultra low-end workstation.
  21.      
  22.      PS Ed-480 is a program which allows access to all the internal 
  23.      settings of the PSS-480's digital synthesizer (the 5 custom banks.) 
  24.      The synthesizer's control panel allows access to 8 of the available 
  25.      parameters.  Using a "patch editor" such as PS Ed-480, it is possible 
  26.      to elicit a much greater variety of sounds from the tone generators.  
  27.  
  28.  
  29.  
  30.      2. PS Ed-480 Features: 
  31.  
  32.         --Allows access to all 36 PSS-480 tone parameters.  
  33.  
  34.         --Parameters can be accesed and modified with a minimum of 
  35.           keystrokes.  
  36.  
  37.         --Save and load tone banks from disk files in standard MIDI System 
  38.           Exclusive (SYSEX) data format.  
  39.  
  40.         --Individual patches can be named for easy identification.  
  41.  
  42.         --Has simple librarian functions--new tone banks can be built out 
  43.           of existing tone banks on disk.  
  44.  
  45.         --Auto backup of a patch before editing allows comparison with what 
  46.           patch sounded like before editing. Previous patch can be restored 
  47.           at any time.  
  48.  
  49.  
  50.  
  51.  
  52.      3. Shareware License:
  53.  
  54.      This program, PS Ed-480, is being distributed as shareware. This means 
  55.      PS Ed-480 is copyrighted material--it is not in the public domain. The 
  56.      author retains all rights to the software, and in no way assumes 
  57.      liability for any consequences resulting from the use of this program.  
  58.      The software may be copied and distributed freely, as long as neither 
  59.      the program nor documentation is modified. The program may not be sold 
  60.      for profit. You are granted the right to use the software for 
  61.      evaluation purposes, and are expected to register as a user if you
  62.      continue to use the software.
  63.  
  64.      For the latest version of the software PLUS one future update, then 
  65.      send $25.00 (an order form is at the end of this file.) to register as 
  66.      a user. Your comments, suggestions, and financial support will be 
  67.      greatly appreciated!  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      4. Getting Started:
  74.  
  75.      The editor can be run from either the hard or floppy disk. I 
  76.      will look for data files in the directory current directory. 
  77.  
  78.      For PS Ed-480 to work properly, you will have to put the PSS-480 in 
  79.      MIDI MODE 00. To be able to test the tone banks in the entire range of 
  80.      the keyboard, make sure AUTO ACCOMPIANMENT is set to NORMAL. Also set 
  81.      VOICE/STYLE area of the LED window to VOICE.  
  82.  
  83.      Start the editor by entering PSED at the DOS prompt. The editor will
  84.      prompt:
  85.                       Load Data from (f)ile or (s)ynth? _
  86.  
  87.      To load the current tone banks from the PSS-480 type 'f' and press
  88.      ENTER. You will be prompted to start the Bulk Data Dump. This is
  89.      done by hitting the TRANSMIT CH/MEMORY BULK DUMP key twice so the
  90.      left side of the LED window flashes. Hitting the '+' key under the
  91.      flashing window will start the data dump. PS Ed-480 should
  92.      display the messages "Data being transferred..." and "Data Received."
  93.      If these messages do not occur, check out your MIDI connections.
  94.  
  95.      When the data is loaded, the values for the various tone parameters 
  96.      are displayed and the "Enter: " prompt appears. To change any para-
  97.      meter, type the number which appears in parantheses near that para-
  98.      meter. PS Ed-480 is programmed to recognize two character numeric
  99.      entries. If such an entry is made, it is automatically accepted 
  100.      without the need to hit the enter key. This means the all editing
  101.      can be done using ONLY the numeric keypad. 
  102.      
  103.      The message area will display the valid range of values for any
  104.      parameter you select. Type in the desired value, or use the "+" or "-" 
  105.      keys.  The tone generator in the synthesizer is updated with the new 
  106.      value, so you can hear the effect of your changes immediately. 
  107.      Repeated use of the "+" and "-" keys (even at the "Enter: " prompt) 
  108.      will raise or lower the selected value one unit at a time.
  109.  
  110.      In a similar way, you can invoke the menu functions at the bottom 
  111.      of the screen by entering the number next to that function. 
  112.  
  113.      One of the best ways to learn how the sounds are created is to 
  114.      study and make changes to the 100 "factory" sounds that are built
  115.      into the PSS-480. To aid in this, I have included several sets of 
  116.      factory sounds in various catagories saved to the diskfiles,
  117.      STRINGS.PSS, HORNS.PSS, KEYBOARD.PSS, etc. 
  118.  
  119.      NOTE: When quickly cycling through values using the "+" or "-" key,
  120.            the data may occasionally get out of step and the PSS-480 will
  121.            display the "Err" error message. The tone bank will temporarily 
  122.            revert to the default settings. The patch you are editing will 
  123.            be downloaded to the PSS-480 when the next change to it is made. 
  124.            The PSS-480's error message can be cleared by hitting the PSS-
  125.            480 MIDI MODE key. I'll see what I can do about fixing this in 
  126.            the next release.
  127.  
  128.  
  129.      5. PS Ed-480 Commands.
  130.  
  131.            (80) Load from File: This command will load all 5 tone bank 
  132.            voices  the tone banks from the file you specify.  If no 
  133.            file extension is given, the extension ".PSS" will be added 
  134.            automatically. If you want to load a file from another 
  135.            directory, you can use the (90) DOS command to "cd" to that 
  136.            directory before loading the file.  
  137.  
  138.            (81) Load from Synth: This command will load all 5 tone 
  139.            bank voices from the PSS-480 through a Memory Bulk Dump.  
  140.  
  141.            (82) Save to File: This command will save all 5 tone bank 
  142.            voices to the file you specify. If no file extension is 
  143.            given, the extension ".PSS" will be added automatically.  
  144.  
  145.            (83) Patch Name: This command allows you to add or edit a 
  146.            name for the current tone bank (patch.) When editing, the 
  147.            editor will only accept a limited number of characters, 
  148.            including trailing spaces. If you are unable to enter 
  149.            characters even though there appears to be room in the 
  150.            field, it is because spaces at the end of the name are 
  151.            taking up space. Move the cursor to the end of the text and 
  152.            hit the delete key several times to clear out the extra 
  153.            space characters.  
  154.  
  155.            (84) Read Patch: This command allows you to read one tone 
  156.            bank from a file on disk into the currently selected tone 
  157.            bank of the PS Ed-480. If no file extension is given, the 
  158.            extension ".PSS" is added automatically. Using this 
  159.            facility, it is possible to build up custom tone bank sets 
  160.            from previously saved groups. Such custom sets can allow 
  161.            you to instrument your recorded sequences or performance 
  162.            splits with any combination of custom patches desired.  
  163.  
  164.            (85) Swap Backup: Whenever you change tone banks, PS Ed-480 
  165.            makes a backup copy of the bank you change to. At any time, 
  166.            this backup copy can be recalled with the current bank 
  167.            settings taking its place as a backup. This allows you to 
  168.            compare the sound of your changes to the original patch by 
  169.            using this command once, playing some notes with the backup 
  170.            settings, then using this command again to get back to your 
  171.            edited version of the patch.  Once you switch to another 
  172.            bank, the changes becomes permanent. So, if you wish too 
  173.            abandon the changes made, use the Swap Backup command, then 
  174.            switch to another bank. Switching back will give you a new 
  175.            backup copy of the original and a chance to try another set 
  176.            of changes.  
  177.  
  178.            (90) DOS: This command allows you to execute DOS commands 
  179.            from within PS Ed-480. The set of double quotes contain the 
  180.            last DOS command executed. Just press enter to re-execute 
  181.            the previous command, or enter a new command.  
  182.  
  183.            (99) EXIT: Leave the PS Ed-480 program.  
  184.  
  185.  
  186.  
  187.  
  188.      6. PSS-480 Parameters.
  189.  
  190.      Part III of the PSS-480 manual does a good job of explaining the 
  191.      basic sound generation capabilities of the PSS-480. I urge you to
  192.      read it carefully if you haven't already. 
  193.  
  194.      PS Ed-480 sound generation parameters are explained in this 
  195.      section with emphasis on the parameters not covered in the PSS-480 
  196.      manual. These Parameters are grouped here, as on the PS Ed-480 screen, 
  197.      by function: 
  198.          
  199.          ENVELOPE parameters control the ADSR (Attack, Decay, Sustain, 
  200.          Release) envelope.  
  201.  
  202.          LEVEL parameters controls the various oscillator volume 
  203.          levels.  
  204.  
  205.          TIMBRE controls the basic sound processed by ENVELOPE and 
  206.          LEVEL settings.  
  207.  
  208.          A last group of parameters consists of various settings for 
  209.          Vibrato and Tremelo effects.  
  210.  
  211.      Each parameter in this section is identified by the PS Ed-480 name 
  212.      and number for that parameter followed by Yamaha's abbreviation as 
  213.      appears in Addendum-1 in the back of the PSS-480's owners manual. 
  214.      For a graphic representation of several of the following 
  215.      parameters, see Addendum-1 (Add-1) in the back of the PSS-480 
  216.      manual.  
  217.  
  218.  
  219.          Bank
  220.      ----------------------------- ENVELOPE -----------------------------
  221.  
  222.          
  223.          Attack     01,02   (AR): Attack Rate. This parameter controls
  224.          the way a sound begins. A high value will cause a sharp attack,
  225.          a lower value a slower, swelling of sound. When the attack 
  226.          has reached its peak, the decay parameters determine what 
  227.          happens next.
  228.          
  229.          Decay1     03,04  (D1R): This is the first stage of the decay
  230.          portion of the Envelope. A lower value here will lengthen
  231.          the time it takes to reach the point where the settings for
  232.          the second portion of the decay envelope take over. 
  233.  
  234.          DecLevel   05,06  (D1L): This is Decay 1 Level. When the initial
  235.          rate of decay (Decay1) reaches this level, a second rate of 
  236.          decay (Decay2) takes over. A lower value here means a higher
  237.          level of the cutoff point. 
  238.  
  239.          Decay2     07,08  (D2R): This is the rate of decay which takes
  240.          over once the Decay 1 cutoff level is reached. This is the 
  241.          "DECAY RATE" parameter on PSS-480 control panel. The lower this 
  242.          value, the longer the time this portion of the decay will be. 
  243.  
  244.          Release    09,10   (RR): Release Rate. This is how long the 
  245.          note will endure after it is turned off (either by lifting the
  246.          key on the keyboard or through a MIDI Note Off command.) This 
  247.          is similar to sustain, but does not require the sustain effect 
  248.          be on. The lower this value, the longer it will take the down
  249.          to die down after it is released. 
  250.  
  251.          Sustain    11,12  (SRR): The Sustain Release rate which is in 
  252.          effect when the sustain button is enabled. A lower value here
  253.          means a longer sustain.
  254.  
  255.          
  256.      ----------------------------  LEVEL  -----------------------------
  257.  
  258.          TotLevel   13,14  (TL): Total Level. This parameter is given two 
  259.          different names on the PSS-480 control panel--MOD. LEVEL for the 
  260.          Modulator, and TOTAL LEVEL for the Carrier. The higher the level
  261.          of the modulator, the greater its "sharpening" effect will be on 
  262.          the tone of the carrier. The greater the level of the carrier, 
  263.          the louder the sound will be overall.
  264.          
  265.          ScaleLow   15,16  (LKS low): Level Key Scaling, low. 
  266.          This parameter controls the relative volume between notes near 
  267.          the low end of the keyboard and notes near the middle of the 
  268.          keyboard. A value of 0 means there will be no change made between 
  269.          low and middl notes.  Values between 1 and 15 represent the 
  270.          loudest to softest settings for notes in the bass register.  
  271.  
  272.          ScaleHi    17,18  (LKS hi): This parameter is identical to the 
  273.          ScaleLow parameter, except that it affects the notes at the 
  274.          high end of the keyboard.
  275.  
  276.          RateScale  19,20  (RKS): Rate Key Scaling. This parameter varies
  277.          the rate at which the envelope parameters are applied. A low 
  278.          value will cause the entire envelope to be lengthened on the 
  279.          lower notes. This mimics the response of aucustic instruments 
  280.          (such as cellos) which take longer to reach a fully articulated
  281.          sound in the low registers.
  282.          
  283.          AmpModEn   21,22  (AMEN): Amplitude Modulation Enable. This 
  284.          parameter controls whether or not Tremolo (a rapid and repeated 
  285.          rising and falling of volume level) is enabled for the Modulator
  286.          and/or Carrier oscillators. A value of 1 here enables Tremelo,
  287.          a value of 0 disables it.
  288.  
  289.          FeedBack   23  (FB): This setting varies the amount of the modulator
  290.          output which is routed back into the input of the modulator. The 
  291.          effect is a reinforcement of the modulator frequencies, with a bit
  292.          of additional complexity of sound. The higher this setting, the more
  293.          sound is being fed back.
  294.  
  295.      ----------------------------  TIMBRE  -----------------------------
  296.  
  297.          SinTable   24,25  (SIN TBL): This parameter selects one of 4 
  298.          wave forms for an oscillator. The four values and forms are:
  299.  
  300.                   0 : Sine Wave 
  301.                   1 : Squared Sine Wave
  302.                   2 : Sine Half Wave
  303.                   3 : Squared Sine Half Wave
  304.  
  305.  
  306.          Detune     28,29  (DT1): This parameter allows you to finely 
  307.          "detune" an oscillator--that is, raise or lower it's pitch a
  308.          small amount. This result of this is a more complex result 
  309.          from the interaction of the two oscillators, since they are 
  310.          slightly out of step. Another effect can be a "beating" or 
  311.          vibrato type pulsing of the sound due as the oscillators 
  312.          interact. A value of 0 represents no detuning, 1..7 
  313.          increasingly sharpen (raise) the tone and  9..15 increasingly 
  314.          flatten (lower) the tone.
  315.  
  316.          Coarse     30,31  (DT2): Coarse detuning. This parameter 
  317.          detunes an oscillator by a large amount. The effect is to 
  318.          produce a less musical, bell or gong type sound. 
  319.  
  320.      ----------------------------(various)-----------------------------
  321.     
  322.          Vibrato Level  32  (PMS): Pitch Modulation Sensitivity. This 
  323.          parameter increases the intensity of the vibrato (rapid rising 
  324.          and falling of pitch) effect, with 0 being the least vibrato, 
  325.          and 3 the greatest.  
  326.  
  327.          Tremolo Level  33  (AMS): Amplitude Modulation Sensitivity. 
  328.          This parameter increases the intensity of the tremolo (rapid 
  329.          rising and falling of volume) effect.
  330.  
  331.          Vibrato Enable 34  (V): Determines whether the vibrato key on 
  332.          the PSS-480 will have any effect, with 1 permitting vibrato and
  333.          disabling it. (note: This parameter does not seem to have any 
  334.          effect, although it is documented in the PSS-480 manual.) 
  335.  
  336.          Sustain Enable 35  (S): Similar to Vibrato Enable, only for the 
  337.          sustain effect.
  338.  
  339.          Vibrato Delay 36   (VBT): Adjusts the length of time before 
  340.          the vibrato effect begins, with 0 being the shortest time and 
  341.          99 being the longest.
  342.  
  343.  
  344.  
  345.      6. Additional Features 
  346.  
  347.      PS Ed-480 has the following command line options:
  348.       
  349.          --If the name of a patch file occurs on the command line PS 
  350.            Ed-480 will load that file automatically, bypassing the 
  351.            "Load from (f)ile or (s)ynth(?) " prompt. For example: 
  352.  
  353.                    C> psed axes
  354.  
  355.            will automatically load the file AXES.PSS for editing.
  356.  
  357.          --A command line flag of "-t" for "transmit" will download
  358.            the specified file to the Yamaha PSS-480 without going 
  359.            into editing mode, but rather terminating after the file
  360.            is downloaded.  For example:
  361.  
  362.                    C> psed axes -t 
  363.  
  364.            will download the file AXES.PSS to the synthesizer, and 
  365.            immediately return you to the DOS prompt.
  366.  
  367.          --The command line flag "-p" for "program" will allow you to
  368.            change parameters in PS Ed-480 by using the VOICE/STYLE 
  369.            select keys on the PSS-480 control panel. To do this, the 
  370.            VOICE/STYLE selector must be set to STYLE. PSED will read
  371.            program changes on channel 15 as keyboard input. In this
  372.            mode the numbers 44 and 66 are maped to the "-" and "+" 
  373.            keys respectively. In some instances, editing in this way
  374.            facilitate more elaborate (two-handed) testing of changes.
  375.  
  376.  
  377.      Screen Colors: 
  378.  
  379.            The configuration file PSED.CFG can be modified to change 
  380.            the screen colors displayed by PS Ed-480. The first line of
  381.            the file must be in the format:
  382.  
  383.                   screen = hh  fields = hh
  384.  
  385.            Since PS Ed-480 only reads the first line of the program
  386.            any additional lines may be considered comments. See the
  387.            
  388.  
  389.  
  390.      PS Ed-480 was written in Turbo C 2.0. The MPU-401 interface 
  391.      routines are those in the cMIDI message manager v. 1.2 copyright 
  392.      1988,1989 cMIDI.  The cMIDI function libraries are commercial 
  393.      products which greatly simplify the task of MIDI programming.  
  394.      (Address: cMIDI, P.O.  Box 4903, East Lansing, MI 48823   Phone: 
  395.      (616) 337-2569.) 
  396.  
  397.  
  398.  
  399.      7. The Future of PS Ed-480.
  400.  
  401.      There are many enhancements I will be making to PS Ed-480 in the 
  402.      near future:
  403.  
  404.          --Interface Refinements. User defined commands which will change
  405.            many parameters at once. This will allow such operations as
  406.            intensifying/softening the envelope with a single command.
  407.            Windowing for disk file lists, tone bank lists, etc.
  408.  
  409.          --Enhanced Librarian Features. A single file will hold all 
  410.            patches and bank sets and allow any combination of patches 
  411.            to be downloaded to the PSS-480 at any time. The librarian
  412.            will also handle PSS-480 Chord and Song Memory Sequences.
  413.  
  414.          --A Simplified Accompaniament feature which will allow easy 
  415.            "step entry" of chord sequences directly from sheet music chord
  416.            symbols, with orchestration changes.
  417.  
  418.          --Integration of the features of the PERF480 performance program 
  419.            (included with this distribution.)  
  420.  
  421.          --Random Generation of patches and performances within user
  422.            defined ranges for quickly testing new ideas. 
  423.  
  424.          --User Suggestions -- what would you like the program to do? If
  425.            it sounds interesting and can be done...
  426.  
  427.  
  428.      Registered users of PSS-480 will be entitled to the latest version 
  429.      of the program plus one automatic update (If it is the latest 
  430.      version of the program you already have, then you will get 
  431.      automatic updates for the next TWO versions.) Any subsequent 
  432.      updates can be obtained by registered users for shipping and 
  433.      handling fee of $3.00.
  434.      
  435.  
  436.  
  437.  
  438.  
  439.      8. Registration Form.  
  440.  
  441.     ------------------------------------------------------------------------
  442.  
  443.  
  444.          To register, please fill in this form and enclose $25.00 in 
  445.          check or money order. You will be sent the latest version of 
  446.          the program and one automatic update (or TWO automatic 
  447.          updates if you already have the latest version.) 
  448.  
  449.         
  450.  
  451.              
  452.          Name ______________________________________________________
  453.  
  454.       Address ______________________________________________________
  455.  
  456.          City ______________________________State ____ Zip _________
  457.  
  458.       
  459.       Computer __________________     MIDI Interface ________________
  460.  
  461.  
  462.       Version of PSS Ed-480 you currently have:   Version ___________
  463.  
  464.  
  465.  
  466.       Mail to:  David Rutkowski
  467.                 2521 Riverside Dr. N.E.
  468.                 Grand Rapids, MI  49505
  469.  
  470.  
  471.       Thank You!
  472.  
  473.                                                                        
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.